home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / byte0787.arc / IWPAS.ARC / READ.ME < prev    next >
Encoding:
Text File  |  1987-05-12  |  5.5 KB  |  142 lines
  1.  
  2. READ.ME                                        12 May 87
  3.  
  4.  
  5.      The files contained on this disk will allow you capture and
  6. save digitized pictures created by the digitizer/transmitter board,
  7. do simple image processing on the digitized pictures, and display
  8. the pictures on either the receiver/display board or on your IBM PC
  9. or compatible using an EGA board.
  10.  
  11.  
  12.  
  13. Hardware Connection
  14. -------------------
  15.  
  16.      The ImageWise boards are connected to your IBM PC through the
  17. COM1 serial port.  A "null modem" cable is necessary so that the
  18. data and handshaking signals are properly routed between the Image-
  19. Wise boards and the computer.  The same cable can be used for both
  20. the digitizer/transmitter and the receiver/display, but only one
  21. board may be connected to the computer at a time.  A cable made
  22. according to the following diagram should work just fine:
  23.  
  24.  
  25.              IBM PC COM1              ImageWise
  26.              -----------              ---------
  27.  
  28.                  2 <_________  _________> 2
  29.                              \/
  30.                  3 <_________/\_________> 3
  31.  
  32.                  4 <_________  _________> 4
  33.                              \/
  34.                  5 <_________/\_________> 5
  35.  
  36.                  7 <____________________> 7
  37.  
  38.  
  39.  
  40.      The next step is to set the option switches.  The digitizer/
  41. transmitter board should be set up as follows:
  42.  
  43.  
  44.           SW1  SW2  SW3  SW4  SW5  SW6  SW7  SW8
  45.           ---  ---  ---  ---  ---  ---  ---  ---
  46.           ON   ON   OFF  OFF  ON   OFF  OFF  OFF
  47.  
  48.  
  49. The receiver/display board works best with the following switch
  50. settings:
  51.  
  52.           SW1  SW2  SW3  SW4  SW5  SW6  SW7  SW8
  53.           ---  ---  ---  ---  ---  ---  ---  ---
  54.           ON   ON   OFF  OFF  OFF  OFF  OFF  OFF
  55.  
  56.  
  57.      Whenever one of the programs expects a picture from the
  58. digitizer/transmitter board, be sure that board is plugged into
  59. the COM1 port.  Likewise, when a program expects to be sending
  60. a picture to the receiver/display board, be sure that board is
  61. plugged in.  If the wrong board is plugged into the COM1 port,
  62. unpredictable results will be obtained.
  63.  
  64.  
  65.  
  66. The Programs
  67. ------------
  68.  
  69. GRAB will store the images in uncompressed format unless you use
  70. the /C flag.  All of the image processing routines expect to see
  71. expanded files, so this trades off some time for some disk space.
  72. If you're not using any of the other routines, you may want to
  73. modify the source code for GRAB so that it doesn't do the expansion.
  74.  
  75.  
  76.  
  77. --- program syntax and descriptions
  78.  
  79. NOTE: A file shown in brackets, as [image2], may be omitted.
  80.       If omitted, the resulting image will replace the first file.
  81.  
  82. Most of these programs are drivers that use procedures and functions
  83. contained in PICTURES.P and IMAGES.P -- they serve as examples more
  84. than finished products!
  85.  
  86. ADD      image1 image2 [image3]        image1 + image2 -> image3
  87. COMPARE  image1 image2 [image3]        Abs(image1+image2) -> image3
  88. COMPRESS image1 [image2]               compresses image data
  89. COUNT    image1 integer                counts # pels >= integer
  90. EDGE     image1 [image2]               finds outlines
  91. EXPAND   image1 [image2]               expands image data
  92. FILTER   image1 [image2]               smooths image edges
  93. GRAB     image1 [/n] [/c]              gets image from transmitter
  94.                                        /c to save compressed file
  95.                                        /n to suppress prompts
  96. HISTO    image1                        displays brightness histogram
  97. INVERT   image1 [image2]               flips brightness levels
  98. MASK     image1 image2 [image3]        removes image1 pels where image2 = 0
  99. MULTIPLY image1 realnumber             scales image brightness
  100. SHOW     image1                        sends image to receiver
  101. SHOWEGA1 image1                        shows image on EGA, fixed levels
  102. SHOWEGA2 image1                        shows image on EGA, histogram levels
  103. SHOWEGA3 image1                        shows image on EGA, false colors
  104. SUBTRACT image1 image2 [image3]        image1 - image2 -> image3
  105. THRESH   image1 integer                removes pels less than integer
  106.  
  107.  
  108. --- these files contain common routines
  109.  
  110. DECLARES P        CONSTs, TYPEs, and VARs
  111. HEXUTIL  P        hex conversion routines
  112. IMAGES   P        image processing routines
  113. PICTURES P        file I/O and suchlike
  114. SERIAL   P        serial port handlers
  115.  
  116. All of the .PAS files include (using {$I}) all of the .P files.  You
  117. can reduce the size of the .COM files by doing some surgery on the
  118. includes to remove the routines that aren't needed.
  119.  
  120.  
  121.  
  122. Usage Notes
  123. -----------
  124.  
  125. Turbo Pascal version 3.0 or later is required to compile all of the
  126. above programs.  Additionally, it must be a version specifically for
  127. the IBM PC and not a generic MS-DOS version.
  128.  
  129. To use COM2 instead of COM1, change the value of 'COMport' in the
  130. DECLARES.P "include" module in accordance with the comment next to
  131. the line.  All the programs that deal with the serial port must
  132. then be recompiled.
  133.  
  134. The default bit rate used by the programs is 28.8 Kbps.  Some slower
  135. machines may not be able to keep up and may require a slower bit rate
  136. for reliable operation.  To slow down the bit rate, change the value
  137. of 'bitsec' in the DECLARES.P "include" module.  All the programs
  138. that deal with the serial port must then be recompiled and the option
  139. switches on the ImageWise boards must be set to match the new bit
  140. rate.
  141.  
  142.